package com.question.business.role.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.question.business.role.entity.Role;
import com.question.business.role.model.ao.*;
import com.question.business.role.model.vo.RoleAddVO;
import com.question.business.role.model.vo.RoleDetailVO;
import com.question.business.role.model.vo.RoleDropDownVO;
import com.question.business.role.model.vo.RoleVO;

import javax.servlet.ServletOutputStream;
import java.util.List;

/**
 * 角色服务
 *
 * @author star
 * @since 2023-09-13
 */
public interface IRoleService extends IService<Role> {

    /**
     * 角色分页查询
     *
     * @param ao 请求参数
     * @return Page<RoleVO> 响应参数
     */
    Page<RoleVO> queryRolePage(RolePageAO ao);

    /**
     * 角色明细查询
     *
     * @param id 角色ID
     * @return RoleDetailVO 响应参数
     */
    RoleDetailVO queryRoleDetail(String id);

    /**
     * 角色新增数据
     *
     * @param ao 请求参数
     * @return RoleAddVO 响应参数
     */
    RoleAddVO addRole(RoleAddAO ao);

    /**
     * 角色修改数据
     *
     * @param ao 数据
     */
    void updateRole(RoleUpdateAO ao);

    /**
     * 角色删除数据
     *
     * @param id 角色ID
     */
    void deleteRole(String id);

    /**
     * 角色批量删除数据
     *
     * @param ids 请求参数
     */
    void deleteBatchRole(List<String> ids);

    /**
     * 角色导出数据
     *
     * @param ao     请求参数
     * @param stream 输出流
     */
    void exportRole(RolePageAO ao, ServletOutputStream stream);

    /**
     * 角色类型启用、停用
     *
     * @param ao 数据
     */
    void enableRole(RoleEnabledAO ao);

    /**
     * 角色下拉列表查询
     *
     * @param ao 请求参数
     * @return List<RoleDropDownVO> 响应参数
     */
    List<RoleDropDownVO> queryRoleDropDown(RoleDropDownAO ao);
}